home *** CD-ROM | disk | FTP | other *** search
/ Palm Pilot Collection / Palm Pilot Collection (Explore the World of Software) (1998).iso / apps / viewer.exe / pimg.txt < prev    next >
Text File  |  1997-12-21  |  5KB  |  143 lines
  1. PalmPilot Image Creator
  2. Copyright ⌐ 1997 Art Dahm
  3. (adahm@earthlink.net)
  4.  
  5.  
  6. Introduction
  7. ------------
  8.  
  9. PalmPilot Image Creator (pimg.exe) is a Windows 95 application for converting
  10. GIF, JPG, PCX, DIB, RLE, and TGA graphic files into PalmPilot .PRC images
  11. compatible with the PalmPilot Image Viewer.
  12.  
  13.  
  14. Installing Image Converter
  15. --------------------------
  16. Unzip the file pimg.exe and NViewLib.dll into their own separate folder.
  17. To start the Image Converter, double click the pimg.exe file from the
  18. Windows 95 Desktop or Explorer.
  19.  
  20. Creating an Image
  21. -----------------
  22.  
  23. The steps involved in creating an Image Viewer image are:
  24.  
  25. - Select the image source.  The source of an image can be a graphic file,
  26. the Windows clipboard or an area of the screen.
  27.  
  28. - If the image source is a graphic file, click the 'Open' button to select
  29. the graphic file to convert.
  30.  
  31. - If the image source is the Widows Clipboard, click the 'Open' button to
  32. load the contents of the clipboard into the image converter.
  33.  
  34. - If the image source is the screen, click the 'Open' button to hide the
  35. image converter window.  Click the left mouse button in the upper left
  36. corner of the area of the screen to be converted.  Drag the mouse to the
  37. lower right corner and click the left mouse button again.  The image
  38. converter window will be restored and the selected area will be loaded into
  39. the image converter.
  40.  
  41. - The Image Title is the name of the image as it will appear on the
  42. PalmPilot.
  43.  
  44. - The Image File is the name of the PalmPilot database file (.PDB) containing
  45. the image which will be hotsynced to the PalmPilot.
  46.  
  47. - Check the 'Compress Image' checkbox if you want the image compressed.
  48. Compressed images take up less space on your PalmPilot, but take longer to
  49. view and may not be viewable under low memory situations.
  50.  
  51. - Click the 'Convert' button to convert the image.  The new PalmPilot
  52. database file will be stored in the same folder as the .BMP file.
  53.  
  54. - If the image is too large, a dialog box will pop up with a suggested amount
  55. to decrease the size of the image by.
  56.  
  57. Command Line Syntax
  58. -------------------
  59. Usage:
  60.  
  61.   pimg [file] [image title] [image notes] [-compress] [-c] [-nocompress] [-nc]
  62.     [-grayscale] [-g] [-bw] [-autoinstall] [-a] [-noautoinstall] [-na]
  63.     [-dither] [-d] [-nodither] [-nd]
  64.  
  65. Where:
  66.  
  67.   [file] is the name of the graphic file to convert.
  68.   [image title] is the name of the image as it will appear in the image list
  69.     on the PalmPilot.
  70.   [image notes] is a string enclosed in quotes which will appear in the
  71.     image notes.
  72.   [-compress] [-c] compresses the image
  73.   [-nocompress] [-nc] doesn't compress the image
  74.   [-grayscale] [-g] creates a grayscale image
  75.   [-bw] creates a black & white image
  76.   [-dither] [-d] dithers the image
  77.   [-nodither] [-nd] doesn't dither the image
  78.   [-autoinstall] [-a] will auto install the image
  79.   [-noautoinstall [-na] won't auto install the image
  80.  
  81. All command line parameters are optional.  However:
  82.  
  83.   If a command line switch is not specified, the state from the most
  84.   recent image conversion will be used.
  85.  
  86.   If a file is specified, the image coverter will exit after it converts
  87.   the image.
  88.  
  89.   A file must be specified in order to specify and image title and image
  90.   notes.
  91.  
  92.   A file and image title must be specified in order to specify image notes.
  93.  
  94. Tips
  95. ----
  96.  
  97. Use your favorite paint program to convert an image to grayscale to get a
  98. better idea of how it will look on your PalmPilot.
  99.  
  100. The PalmPilot uses four levels of gray (white, light gray, dark gray and
  101. black) which are evenly distributed among the range of grays used in a paint
  102. program.  If an image loses certain details when converted, try changing the
  103. brightness of some of the colors so they map to a different grayscale level.
  104.  
  105. If an image is too large, use your paint program's Crop feature to decrease
  106. the size of the image.
  107.  
  108. Updates
  109. -------
  110. v2.9    - Added command line options
  111. v2.8b
  112.     - Fixed bug which caused B&W images to be offset to the left by one pixel.
  113. v2.8
  114.     - Improved process used to convert color pictures to grayscale.
  115. v2.7
  116.     - Added image compression.
  117. v2.5
  118.     - Added support for GIF, JPG, PCX, DIB, RLE, and TGA graphic file types.
  119. v2.4
  120.     - Added a light next to the Convert button which turns red if an image is too large to be converted
  121. v2.3
  122.     - Added ability to convert an image in the Windows clipboard
  123.     - Added ability to capture and convert an area of the screen
  124. v2.2
  125.     - Fixed multiple user auto-install bug
  126. v2.1
  127.     - Added grayscale 'dither' option
  128.     - Added black & white 'dither' option
  129. v2.0
  130.     - Redesigned UI: Tabbed dialog replaces multiple windows.
  131.     - Added auto-install option: No more need to run USR Install Tool.
  132.       Just convert and hotsync.
  133.     - Added preview tab: See how PalmPilot images will look before
  134.       installing them.
  135.     - Removed 'dither' option
  136. V1.3
  137.     - Added support for black & white images
  138. V1.2
  139.     - Added support for attaching notes to images
  140. V1.1
  141.     - Added 'dither' option to simulate three more grayscale levels.
  142.     - Increased maximum image size by about 10%
  143.